home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_hylafax.idb / usr / freeware / man / cat1 / textfmt.Z / textfmt
Encoding:
Text File  |  1999-07-16  |  13.7 KB  |  329 lines

  1.  
  2.  
  3.  
  4. TTTTEEEEXXXXTTTTFFFFMMMMTTTT((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((MMMMaaaayyyy 11117777,,,, 1111999999996666))))         TTTTEEEEXXXXTTTTFFFFMMMMTTTT((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      textfmt - convert text to POSTSCRIPT for facsimile
  10.      transmission
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ////uuuussssrrrr////ffffrrrreeeeeeeewwwwaaaarrrreeee////ssssbbbbiiiinnnn////tttteeeexxxxttttffffmmmmtttt [ _o_p_t_i_o_n_s ] [ _f_i_l_e_s...  ]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _t_e_x_t_f_m_t takes ASCII text and generates formatted POSTSCRIPT
  17.      suitable for facsimile transmission.  It is usually invoked
  18.      as a filter program by the _s_e_n_d_f_a_x(1) program.  Input files
  19.      may be specified on the command line.  If none are given,
  20.      then _t_e_x_t_f_m_t will read from standard input.
  21.  
  22.      By default, _t_e_x_t_f_m_t will generate an output document that is
  23.      formtted with a single vertical column of text, set in a 10
  24.      point fixed width font, and with a simple page header that
  25.      consists of the file name, last modification date, and the
  26.      page number.  Pages are generated according to the default
  27.      page dimensions (see _p_a_g_e_s_i_z_e_s(4F)).  When multi-column
  28.      output is requested, text is set by default with a 7 point
  29.      fixed width font.
  30.  
  31. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  32.      Many of the options to _t_e_x_t_f_m_t have been chosen for
  33.      compatibility with the Adobe Systems' _e_n_s_c_r_i_p_t program;
  34.      other options are for features that are not provided by
  35.      _e_n_s_c_r_i_p_t.
  36.  
  37.      ----1111   Set text in one column.
  38.  
  39.      ----2222   Set text two columns.
  40.  
  41.      ----BBBB   Suppress page headers.
  42.  
  43.      ----cccc   Clip long text lines instead of wrapping them at page
  44.           margins.
  45.  
  46.      ----DDDD   Do not use ISO 8859-1 encoding in the generated
  47.           POSTSCRIPT.
  48.  
  49.      ----ffff _f_o_n_t
  50.           Set text using the POSTSCRIPT font named _f_o_n_t.
  51.  
  52.      ----GGGG   Use a gaudy-style page header.
  53.  
  54.      ----mmmm _c_o_l_s
  55.           Set text in _c_o_l_s columns.
  56.  
  57.      ----MMMMllll====#,rrrr====#,tttt====#,bbbb====#
  58.           Set the page margins; the default margins are:  left
  59.           and right .25 inch, top .85 inch, bottom .5 inch.
  60.  
  61.  
  62.  
  63. Page 1                                          (printed 6/24/99)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TTTTEEEEXXXXTTTTFFFFMMMMTTTT((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((MMMMaaaayyyy 11117777,,,, 1111999999996666))))         TTTTEEEEXXXXTTTTFFFFMMMMTTTT((((1111))))
  71.  
  72.  
  73.  
  74.      ----oooo   Draw an outline around each column of text; the
  75.           specified number defines the width of the line that is
  76.           drawn.
  77.  
  78.      ----pppp _p_t_s
  79.           Set text using fonts with _p_t_s point size.
  80.  
  81.      ----rrrr   Set pages rotated by 90 degrees (in ``Landscape
  82.           mode'').
  83.  
  84.      ----RRRR   Set pages unrotated (in ``Portrait mode'').
  85.  
  86.      ----ssss _s_i_z_e
  87.           Set the output size according to the named page size.
  88.           Images are normally created with a system-default page
  89.           size (usually letter-size pages, 8.5" by 11", for sites
  90.           in North America).  Alternate page sizes are specified
  91.           symbolically using either the name or abbreviation of
  92.           an entry in the _p_a_g_e_s_i_z_e_s(4F) database; e.g.  _a_3 (ISO
  93.           A3), _a_4 (ISO A4), _a_5 (ISO A5), _a_6 (ISO A6), _b_4 (ISO
  94.           B4), _n_a-_l_e_t (North American Letter), _u_s-_l_e_g (American
  95.           Legal), _u_s-_l_e_d (American Ledger), _u_s-_e_x_e (American
  96.           Executive), _j_p-_l_e_t (Japanese Letter), and _j_p-_l_e_g
  97.           (Japanese Legal).  Comparisons are case-insensitive and
  98.           any match of a substring of the full page-size name is
  99.           sufficient; e.g. ``legal'' would match ``American
  100.           Legal''.
  101.  
  102.      ----UUUU   Reverse collate pages; that is the last page will
  103.           appear first in the resultant POSTSCRIPT, then the
  104.           next-to-last page, etc.
  105.  
  106.      ----VVVV _s_p_a_c_i_n_g
  107.           Set the line height; the default height is 1.2 x point
  108.           size.
  109.  
  110. CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  111.      _t_e_x_t_f_m_t reads configuration information from the files
  112.      ////uuuussssrrrr////ffffrrrreeeeeeeewwwwaaaarrrreeee////lllliiiibbbb////ffffaaaaxxxx////hhhhyyyyllllaaaa....ccccoooonnnnffff, and ~~~~////....hhhhyyyyllllaaaarrrrcccc; in that
  113.      order.  Configuration files follow the conventions described
  114.      in _h_y_l_a_f_a_x(1).  The following configuration parameters are
  115.      recognized:
  116.      TTTTaaaagggg               TTTTyyyyppppeeee       DDDDeeeeffffaaaauuuulllltttt      DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
  117.      Columns           integer    1            number of columns in formatted output
  118.      FontDir           string     _s_e_e _b_e_l_o_w    directory for font metric files
  119.      GaudyHeaders      boolean    No           enable/disable guady page headers
  120.      ISO8859           boolean    Yes          use ISO 8859-1 character encoding
  121.      LineWrap          boolean    Yes          wrap/truncate text lines
  122.      Orientation       string     portrait     orientation of text on page
  123.      OutlineMargin     inches     0            width of outline line
  124.      PageCollation     string     forward      collate pages in forward or reverse direction
  125.      PageHeaders       boolean    Yes          enable/disable page headers
  126.  
  127.  
  128. Page 2                                          (printed 6/24/99)
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135. TTTTEEEEXXXXTTTTFFFFMMMMTTTT((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((MMMMaaaayyyy 11117777,,,, 1111999999996666))))         TTTTEEEEXXXXTTTTFFFFMMMMTTTT((((1111))))
  136.  
  137.  
  138.  
  139.      PageHeight        float      -            output page height
  140.      PageMargins       string     _s_e_e _b_e_l_o_w    margins for formatted page
  141.      PageSize          string     default      output page size from database
  142.      PageWidth         float      -            output page width
  143.      TabStop           integer    8            inter-stop setting in characters
  144.      TextFont          string     Courier      name of font for setting text
  145.      TextLineHeight    inches     -            text formatting line height control
  146.      TextPointSize     inches     _s_e_e _b_e_l_o_w    size to use in setting text
  147.  
  148.      The configuration parameters are explained below.  Most
  149.      parameters correspond to a command line option.  Parameter
  150.      values identified above as _i_n_c_h_e_s are converted according to
  151.      the following conventions (where ``#.##'' is a decimal
  152.      number):
  153.           #.##bp    big point (1in = 72bp)
  154.           #.##cc    cicero (1cc = 12dd)
  155.           #.##cm    centimeter
  156.           #.##dd    didot point (1157dd = 1238pt)
  157.           #.##in    inch
  158.           #.##mm    millimeter (10mm = 1cm)
  159.           #.##pc    pica (1pc = 12pt)
  160.           #.##pt    point (72.27pt = 1in)
  161.           #.##sp    scaled point (65536sp = 1pt)
  162.  
  163.      Unit names can be upper or lower case but no white space is
  164.      permitted between the number and the unit.  Values specified
  165.      with no unit are interpreted as points.
  166.  
  167.      CCCCoooolllluuuummmmnnnnssss        The number of columns to set text in.
  168.                     (Equivalent to the ----mmmm option.)
  169.  
  170.      FFFFoooonnnnttttDDDDiiiirrrr        The directory where Adobe Font Metric (AFM)
  171.                     files are located; by default
  172.                     /usr/lib/DPS/AFM.
  173.  
  174.      GGGGaaaauuuuddddyyyyHHHHeeeeaaaaddddeeeerrrrssss   Control whether or not to use a gaudy-style
  175.                     page header.  (Equivalent to the ----GGGG option.)
  176.  
  177.      IIIISSSSOOOO8888888855559999        Control the use of ISO 8859-1 encoding in the
  178.                     generated POSTSCRIPT (Equivalent to the ----DDDD
  179.                     option.)
  180.  
  181.      LLLLiiiinnnneeeeWWWWrrrraaaapppp       Control whether long text lines are wrapper
  182.                     or truncated at the right hand margin.
  183.                     (Equivalent to the ----cccc option.)
  184.  
  185.      OOOOrrrriiiieeeennnnttttaaaattttiiiioooonnnn    Control whether pages are oriented
  186.                     horizontally (``landscape'') or vertically
  187.                     (``portrait'').  (Equivalent to the ----rrrr and ----RRRR
  188.                     options.)
  189.  
  190.  
  191.  
  192. Page 3                                          (printed 6/24/99)
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199. TTTTEEEEXXXXTTTTFFFFMMMMTTTT((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((MMMMaaaayyyy 11117777,,,, 1111999999996666))))         TTTTEEEEXXXXTTTTFFFFMMMMTTTT((((1111))))
  200.  
  201.  
  202.  
  203.      OOOOuuuuttttlllliiiinnnneeeeMMMMaaaarrrrggggiiiinnnn  Control whether columns of text have a line
  204.                     drawn around them and the width of the line.
  205.                     Setting this parameter to 0 disables
  206.                     outlines.  (Equivalent to the ----oooo option.)
  207.  
  208.      PPPPaaaaggggeeeeCCCCoooollllllllaaaattttiiiioooonnnn  Control whether the output file has pages
  209.                     collated in the same order as the input file
  210.                     (``forward'') or in reverse order
  211.                     (``reverse).  (Equivalent to the ----UUUU option.)
  212.  
  213.      PPPPaaaaggggeeeeHHHHeeeeaaaaddddeeeerrrrssss    Control whether page headers are generated.
  214.                     (Equivalent to the ----BBBB option.)
  215.  
  216.      PPPPaaaaggggeeeeHHHHeeeeiiiigggghhhhtttt     Set the output page height in inches (in
  217.                     inches).
  218.  
  219.      PPPPaaaaggggeeeeMMMMaaaarrrrggggiiiinnnnssss    Set the output page dimensions.  Dimensions
  220.                     are specified as string of the form:
  221.                     ``llll====#,rrrr====#,tttt====#,bbbb====#'' where llll indicates the
  222.                     left margin, rrrr indicates the right margin, tttt
  223.                     indicates the top margin, bbbb indicates the
  224.                     bottom margin, and numbers are interpreted as
  225.                     _i_n_c_h_e_s.  (Equvalent to the ----MMMM option.)
  226.  
  227.      PPPPaaaaggggeeeeSSSSiiiizzzzeeee       Set the output page dimensions by name.
  228.                     (Equivalent to the ----ssss option.)
  229.  
  230.      PPPPaaaaggggeeeeWWWWiiiiddddtttthhhh      Set the output page width in inches (in
  231.                     inches).
  232.  
  233.      TTTTaaaabbbbSSSSttttoooopppp        Set the tab stop distance; in characters.
  234.  
  235.      TTTTeeeexxxxttttFFFFoooonnnntttt       Set the name of font to use for setting text.
  236.                     (Equivalent to the ----ffff option.)
  237.  
  238.      TTTTeeeexxxxttttLLLLiiiinnnneeeeHHHHeeeeiiiigggghhhhtttt Set the vertical text line height and
  239.                     spacing.  (Equvalent to the ----VVVV option.)
  240.  
  241.      TTTTeeeexxxxttttPPPPooooiiiinnnnttttSSSSiiiizzzzeeee  Set the point size to use in setting text.
  242.                     (Equvalent to the ----pppp option.)
  243.  
  244. NNNNOOOOTTTTEEEESSSS
  245.      If _t_e_x_t_f_m_t is unable to locate font metric information for a
  246.      font, then it will use a fixed-width metric that is 60% of
  247.      the text point size; this metric will almost certainly
  248.      result in incorrectly formatted POSTSCRIPT.
  249.  
  250.      _t_e_x_t_f_m_t is distantly related to the _l_p_t_o_p_s program written
  251.      by Don Beebe.
  252.  
  253. FFFFIIIILLLLEEEESSSS
  254.      /usr/freeware/lib/fax/hyla.conf    system-wide configuration file
  255.  
  256.  
  257.  
  258. Page 4                                          (printed 6/24/99)
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265. TTTTEEEEXXXXTTTTFFFFMMMMTTTT((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((MMMMaaaayyyy 11117777,,,, 1111999999996666))))         TTTTEEEEXXXXTTTTFFFFMMMMTTTT((((1111))))
  266.  
  267.  
  268.  
  269.      ~/.hylarc                          per-user configuration file
  270.      /usr/freeware/lib/fax/pagesizes    page size database
  271.      /usr/lib/DPS/AFM                   font metric files
  272.  
  273. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  274.      _h_y_l_a_f_a_x(1), _s_e_n_d_f_a_x(1), _p_a_g_e_s_i_z_e_s(4F)
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324. Page 5                                          (printed 6/24/99)
  325.  
  326.  
  327.  
  328.